home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Tele / I-L / LaunchRRH.Txt < prev    next >
Encoding:
Text File  |  1987-05-25  |  3.6 KB  |  73 lines  |  [TEXT/MACA]
  1. Structure and contents of the "LaunchRRH" file
  2. ----------------------------------------------
  3. Current for version 1.01 of Red Ryder Host
  4.  
  5. Strategy:  Just before an external application is launched through a
  6. Red Ryder Host menu command type #50, Red Ryder Host writes a 68 byte
  7. data file titled "LaunchRRH" (no quotes) in the same volume (and HFS
  8. folder) as Red Ryder Host resides.  This data file is used by the
  9. external application to learn about the person entering the application,
  10. and by Red Ryder Host upon re-entry.  Therefore, be very careful if you
  11. change any of the information in the "LaunchRRH" file, as Host needs and
  12. expects it to be correct upon re-entry.  All external applications should
  13. lay within the same volume (and HFS folder) as Host, and the external
  14. application should never change the default volume (or working directory
  15. in the case of HFS).
  16.  
  17.  
  18. In the below document, a "byte" refers to an unsigned 8-bit value, and a
  19. "long" refers to an unsigned 32-bit value (4 bytes).
  20.  
  21. 1 byte: non-zero if the "meter" is running (from a menu command #16).
  22. 1 byte: caller was using expert menu mode if non-zero.
  23. 1 byte: non-zero if he get's the 10 minute warning message at next menu.
  24. 1 byte: non-zero means caller is asking for chat with sysop at each menu.
  25. 1 byte: baud rate (0 = 300, 1 = unused, 2 = 1200, 3 = 2400, 4 = local).
  26. 1 byte: non-zero if hold system offline for sysop after this call.
  27. 1 byte: non-zero means sysop is not available for chat.
  28. 1 byte: emulate 300 baud for local signons if non-zero.
  29. 1 byte: year he connected (last 2 digits).
  30. 1 byte: month he connected.
  31. 1 byte: day he connected.
  32. 1 byte: hour he connected.
  33. 1 byte: minute he connected.
  34. 1 byte: second he connected.
  35. 1 long: offset position of caller's record in Userlog file.
  36. 1 long: if "meter" is running this is the TickCount it started at.
  37. 1 byte: user's current time limit.
  38. 1 byte: user's current clearance level.
  39. 1 byte: bit-mapped settings for combined boards #2-9.
  40. 1 byte: bit-mapped settings for combined boards #10-17.
  41. 1 byte: bit-mapped settings for combined boards #18-20.
  42. 41 bytes: menu file VOLUME:FILENAME to execute upon re-entry to Host.
  43.  
  44. The external application will most likely be concerned with only a few
  45. of the above items, the rest are used by Host to "remember" certain
  46. dynamic settings between launching and re-entry.  For instance, the
  47. external application would probably need to only use the baud-rate
  48. setting (to re-open the serial port for data I/O), the month/day/year/
  49. hour/minute/second settings if they wish to watch out for the caller's
  50. time limit, and the offset position of the caller's record in the userlog
  51. file so they can refer to the user by his first/last name and get/put
  52. other information about him.  The userlog structure is documented in the
  53. "Inside Red Ryder Host" chapter.
  54.  
  55.  
  56. A COUPLE OF BUGS TO BE AWARE OF IN RED RYDER HOST 1.01 THAT HAVE BEEN
  57. CONFIRMED (AND WILL BE FIXED IN THE NEXT RELEASE).
  58.  
  59. 1) The user's current time limit/security level in the "LaunchRRH" file
  60. may not match what is in the user's userlog record if they had been
  61. changed in the same session as the caller launches the external
  62. application.  You should use those in the "LaunchRRH" instead of those in
  63. the userlog record.  Host erroneously uses the values from the userlog
  64. record upon re-entry, which may befuddle some upgraded users as to why
  65. they've suddenly become blackballed.
  66.  
  67. 2) Host 1.01 will always return to the Main Menu upon re-entry due to
  68. a code error in Host 1.01 that reads the wrong location in the "LaunchRRH"
  69. file for the menu to execute upon re-entry.  You'll also get a bothersome
  70. error message (probably a -35) in your CALLERLOG file (if you've checked
  71. for System Errors to be included in your callerlog).
  72.  
  73.